// 📁 service/UserService.java
package com.library.management.service;

import com.library.management.entity.User;
import com.library.management.enums.UserRole;
import com.library.management.enums.UserStatus;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;

import java.util.List;
import java.util.Optional;

/**
 * 用户服务接口
 * 处理用户相关的业务逻辑
 */
public interface UserService extends BaseService<User, Long> {

    /**
     * 根据用户名查找用户
     */
    Optional<User> findByUsername(String username);

    /**
     * 根据邮箱查找用户
     */
    Optional<User> findByEmail(String email);

    /**
     * 根据用户名或邮箱查找用户
     */
    Optional<User> findByUsernameOrEmail(String username, String email);

    /**
     * 检查用户名是否存在
     */
    boolean existsByUsername(String username);

    /**
     * 检查邮箱是否存在
     */
    boolean existsByEmail(String email);

    /**
     * 根据角色查找用户
     */
    List<User> findByRole(UserRole role);

    /**
     * 根据状态查找用户
     */
    List<User> findByStatus(UserStatus status);

    /**
     * 分页查询指定角色的用户
     */
    Page<User> findByRole(UserRole role, Pageable pageable);

    /**
     * 根据关键词搜索用户（用户名或真实姓名）
     */
    List<User> searchUsers(String keyword);

    /**
     * 更新用户状态
     */
    User updateStatus(Long userId, UserStatus status);

    /**
     * 更新用户角色
     */
    User updateRole(Long userId, UserRole role);

    /**
     * 更新用户密码
     */
    User updatePassword(Long userId, String newPassword);

    /**
     * 验证用户密码
     */
    boolean validatePassword(Long userId, String password);

    /**
     * 检查用户是否可以借书
     */
    boolean canUserBorrowBook(Long userId);

    /**
     * 获取用户当前借阅数量
     */
    long getCurrentBorrowCount(Long userId);

    /**
     * 统计用户总借阅次数
     */
    long getTotalBorrowCount(Long userId);

    /**
     * 查找可以借书的活跃用户
     */
    List<User> findUsersAvailableForBorrowing();

    /**
     * 查找有逾期罚款未支付的用户
     */
    List<User> findUsersWithUnpaidFines();

    /**
     * 统计各角色用户数量
     */
    long countByRole(UserRole role);

    /**
     * 统计各状态用户数量
     */
    long countByStatus(UserStatus status);
}